home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 176-200 / scopedisk197 / bizcalc / bizcalc.doc < prev    next >
Text File  |  1995-03-19  |  12KB  |  244 lines
  1.                             BizCalc v1.1
  2.                             ~~~~~~~~~~~~                 
  3.         BizCalc may be freely redistributed. Enjoy and
  4.         pass it around with all the documentation files. 
  5.  
  6. This program is based on MortCalc, which was published on Fred Fish
  7. disk no. 385. I changed the name because some users thought that it was
  8. only for mortgage loans. Enter BizCalc, the do-it-all loan calculator!
  9.  
  10. The original set of equations (enhanced to support periods less than a month)
  11. comes from an AmigaBasic demo signed by Amiga grand master Jim Butterfield.
  12. For the Table to screen option, I used the code of Teks, Pierre
  13. Baillargeon's compact and yet user-friendly file reader. Iconify routine
  14. is from Leo Schwab, "the guy in the cape". Compiled with Aztec 3.6a. 
  15.  
  16. WARNING
  17. ~~~~~~~
  18. The author of this program shall not be held responsible for any lost 
  19. incurred by users.
  20. Please don't blame me if some day your house is repossessed!  :^) 
  21.  
  22. OPERATION
  23. ~~~~~~~~~
  24.   -from the CLI:    BizCalc   [-option -option ...] 
  25.                     BizCalc ?                   This help screen 
  26.                                                       
  27.     Options:  (where N is an integer or decimal value)                
  28.          -pN  Principal N (decimal or integer)        
  29.          -rN  Rate N                                  
  30.          -lN  Length N (months)                       
  31.          -bN  Balance N                               
  32.          -cN  Compounded every N months  (default: 1 ; Canada, 6)  
  33.          -nN  N payments/year (default: 12)
  34.          -f   Change the default language from english to french  
  35.          -u   Send unformated data (6 decimals, not rounded) to
  36.               standard output (CLI).  Can be redirected to the printer
  37.               with the command line: BizCalc >PRT: -u.
  38.  
  39.    Why so many CLI options? So that you can run with your own values
  40.    from a directory utility like DiskMaster, SID, etc. Please note  
  41.    that "1w" and "2w" must be used for compounding periods less than 
  42.    one month. Example: 1> bizcalc -l48 -n52 -c1w 
  43.  
  44.   -from the Workbench: just double click on the icon. See PRESELECTION.
  45.  
  46.    Standard icon.library and mathieee.library are required; boot form a  
  47.    standard Workbench. Version 1.2, 1.3 and 2.0 are O.K.
  48.  
  49. BUTTONS AND BOXES  
  50. ~~~~~~~~~~~~~~~~~ 
  51. If you are fluent with Amigese, run BizCalc right away and read this
  52. doc later for the fine points.
  53.  
  54. Select the operation you want to do (the unknown value to calculate) by
  55. clicking in one of the buttons at the left (CAPITAL, RATE, LENGTH,
  56. BALANCE or PAYMENT). The amortization LENGTH is the length of the loan.
  57. The selected button stays highlighted and the message box confirms your
  58. selection. At startup, BizCalc will compute the monthly payments for
  59. the figures displayed in the value boxes (PAYMENT selected). 
  60.  
  61. To change a known value, select a box by clicking in it and edit the
  62. digits with the keyboard or the keypad (DEL, Backspace and the left and
  63. right cursor keys work the usual way). You may click CALCULATE anytime.
  64. [RETURN] is not needed to enter a value; however, it places the cursor
  65. in the next box. Also click CALCULATE whenever you loose the cursor. 
  66.  
  67. To clear a box, you may use the Right Amiga X combination (press X
  68. while holding down the right fancy A key). Clearing a box just makes
  69. room to enter a new value; to really change a value in memory, you have
  70. to click CALCULATE. This button enters all the displayed figures and
  71. the result is highlighted by the cursor in the selected value box.
  72.  
  73. Clicking on the CALCULATE button updates the display and formats the
  74. output with $, %, etc. The value boxes accept any character but will 
  75. read in only digits and decimal points. Naturally, any non-numerical
  76. entry may generate an error message.
  77.  
  78. When the RATE and BALANCE are computed, errors messages may be
  79. displayed if out-of-limits conditions are encountered.
  80.  
  81. The INTEREST box shows the cumulative interest amount paid. This is the
  82. only box that doesn't accept a direct input; this value is updated each
  83. time a new payment is calculated.
  84.  
  85. The PRINT button gets you a hard copy of all the values. This short
  86. list is different from the "Table to the printer" menu option.
  87. CAUTION: BizCalc will hang and wait if this option is selected while
  88.          the printer is not on line. 
  89.          This option is incompatible with the "Table to file" option. 
  90.  
  91. The "Compounded every" and "Number of payments/year" value boxes allow
  92. direct entry of integers or decimals values. This is the "expert" mode
  93. for those who know what they are doing. In a nutshell, in the U.S.A.,
  94. mortgage loans are compounded monthly, but semiannually in Canada
  95. (every 6 months). There are no such legal restrictions for personal
  96. loans; for instance, a weekly loan (52 payments/year) will normally be
  97. compounded weekly (1w).
  98.  
  99. If you don't feel ready for the expert mode, you might as well use the
  100. ">>>" buttons to select the correct values. Thus, BizCalc will accept
  101. "1w" for 0.2307692, which is the compounding factor for weekly loans.
  102. Or you may use the "Type of Loan" menu, which automatically puts the
  103. correct value in the "Compounded every" box, but only for mortgage
  104. loans, U.S.A. or Canada. Then, if the "Number of payments/year" is not
  105. 12, use the ">>>" buttons to set it.
  106.  
  107. To Iconify, click the upper right pictogram; you can move the icon around.
  108. To restore the display, double-click the icon.
  109.  
  110. To QUIT, hit the Close button in the upper left corner of the BizCalc
  111. window, or use the Project menu option. 
  112.  
  113. MENUS
  114. ~~~~~
  115.     Project Menu: Info help screen, Author's address, Calculate and Quit
  116.     commands. Keyboard shortcuts: Right Amiga I, A and C.
  117.  
  118. Amortization Table Menu: Click to toggle an option on or off
  119. *To Screen:
  120.     Displays the list of all the payments in a small window. The computing
  121.     of the amortization table may take some time, especially if the number
  122.     of periods is over 100 (weekly loans, for instance). You can scroll up
  123.     or down the list with the proportional button to the right, with the up
  124.     and down arrow keys or by clicking up or down in the small window.
  125.     Memory is allocated dynamically, so BizCalc multitasks nicely with
  126.     other applications.
  127. *To Printer
  128.     Outputs a summary of the values and the complete table. It is advisable
  129.     to check the list on the screen first.
  130. *To File
  131.     Saves in the current directory the summary and the complete table in a
  132.     file whose name defaults to BCalc.lst. Works in append mode; all the
  133.     tables are joined one after the other if the file name is unchanged.
  134.     This is handy to update permanent files or if you change one or more
  135.     factor some year, like a lump sum payment on the anniversary of the
  136.     loan. To change the path or file name, edit the file name displayed in
  137.     the message box, for example: "dh0:finances/my_loan_table.lst", to save
  138.     your file in the Finance drawer of dh0:.
  139.     IMPORTANT: Type [RETURN] to enter the new file name.
  140.  
  141. Type of Loan Menu:
  142.     Canada option in the Mortgage submenu will change the default U.S.A.    
  143.     monthly compounding to legal canadian semiannually compounding. The
  144.     correct value is dispayed in the "Compounded every" box.  With the
  145.     startup values, PAYMENT is $132.15 (USA) and $131.04 (Canada). BizCalc
  146.     values have been verified with annuity tables and are very reliable. If
  147.     you have a weekly or biweekly loan, then use the ">>>" button to set
  148.     the "Number of payments/year" box to 52 or 26 weeks, respectively. 
  149.  
  150. SHORT CUTS 
  151. ~~~~~~~~~~
  152. To clear a box, you may use the Right Amiga "X" combination (press X
  153. while holding down the right fancy A key). The Right-Amiga "Q"
  154. combination undoes any change and gives you a second chance.
  155.  
  156. All the value boxes (exept LENGTH) need digits only, so you don't have
  157. to enter any comma, $ or % ; CALCULATE does that for you. 
  158.  
  159. As for the LENGTH box, it uses any non-digit character(s) to separate 2
  160. integer fields (years and months). So, the following entries are
  161. equivalent:
  162.             10 yrs 2 mo.
  163.             10 ans 2 mois
  164.             10/2
  165.             0y122        (122 months is 10 years and 2 months)
  166.  
  167. The years field is mandatory, but the months field is optional. Please
  168. note that the LENGTH box accepts integers only. All the other boxes
  169. take both integer and decimal values. BizCalc rejects negative values. 
  170.  
  171. You may operate BizCalc without the mouse if you use the arrow keys 
  172. within a box and the <RETURN> key to move from box to box. Place the
  173. mouse pointer on CALCULATE  and simultaneously press Left Alt and Left
  174. Amiga to simulate a mouse click...
  175.  
  176. CAUTION: The Right-Amiga C keyborad shortcut works as indicated, but a
  177. small bug eats up the cursor. Type Left Arrow to get it back without
  178. changing anything else. I didn't squash that bug because it has a handy
  179. side effect: the cursor will come back in the starting box instead of
  180. in the results box. Some users may actually prefer that. This shows
  181. quite appropriately that one man's bug may be another man's feature.
  182.  
  183. ROAD TEST 
  184. ~~~~~~~~~ 
  185. BizCalc can do a lot of things besides calculating your instalments.
  186. For instance, using the startup values, you may want to know how long
  187. it would take to pay the capital if the payments were set at $150. To
  188. find out, select the LENGTH box (unknown value), then edit the PAYMENT
  189. value box to $150.00 and click CALCULATE. 
  190.  
  191. You may wish to know the balance on a loan after, say, one year. Just
  192. select BALANCE as the unknown value and enter 1 in the LENGTH box. For
  193. lump sum payments, find the BALANCE at that date and subtract the lump
  194. sum amount. Then go on with these new values.
  195.  
  196. Watch out for asymptotic values or else, you may have to pay your
  197. mortgage for the whole eternity. For instance, select LENGTH as the
  198. unknown value and try to increment the CAPITAL until you get an error
  199. message (which will show up when the LENGTH exceeds 9999 months!). You
  200. will find out that at some point just before the error message, a
  201. difference of one miserable dollar in the principal adds *years* of
  202. payments. 
  203.  
  204. If you add fractions of cent (say $0.003) to the PAYMENT, you may
  205. notice an increment of a few dollars in CAPITAL. The rounding off of
  206. figures also explains why you may have in few cents left (or see a
  207. minus sign) in BALANCE when the amortization LENGTH is over. Use the
  208. CLI -u option (unformatted) if you need a precision of six decimals.
  209.  
  210. BizCalc gives you all the figures you need to shop for a mortgage. You
  211. no longer have to take for granted everything your loan agent tells
  212. you, and you may even teach him a trick or two.
  213.  
  214. PRESELECTION OF DEFAULT VALUES 
  215. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 
  216. You may change some startup values by editing the Tool Types box of the
  217. icon (Workbench ICON menu item). CAN=1 and FR=1 will change the
  218. defaults options to Canada and French, respectively. Delete these
  219. entries to get the default values (USA and English). Invisible language
  220. selection is a welcome feature in a small world like ours.
  221.  
  222. You may use the same tool to change the default startup values. For
  223. instance, typing in CAPITAL=44832.44, RATE=11.75, LENGHT=134,
  224. BALANCE=4000, COMP=2w, NPY=26 will start BizCalc with these values.
  225. Notes:  LENGTH has to be in months 
  226.         1w must be used for "one week", and 2w for "two weeks"
  227.         Lower/upper CASE are important!
  228.  
  229. AGITPROP 
  230. ~~~~~~~~ 
  231. The next version of BizCalc will incorporate a lot of new features, 
  232. like a complete set of help screens, file manipulation options, an Arp
  233. file requester to load and save config files, a file reader, amortization
  234. tables with actual calendar dates  and more. This version is available
  235. to registered BizCalc users only. So, if you use BizCals regularly, do
  236. yourself a favor and order BizCalc Professional by sending $15 to:
  237.  
  238.  
  239.                                             Michel Laliberté
  240.                                             875 Dollard
  241.                                             Outremont, Québec
  242.                                             H3V 3G8 Canada
  243.         Any comment is welcome.
  244.